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(54) Marshaling and unmarshaling framework for supporting filters in a distributed object system 



(57) In order to support filtering operations in a 
CORBA system, the marshaling and unmarshaling 
process is encapsulated in a server invocation object 
created from a class which contains data, including the 
request ID, the marshal buffer and the marshal and 
unmarshal methods. Filtering is supported by extending 
the class with a subclass that overrides the marshal and 



unmarshal methods to invoke the filters at the proper 
points. During operation, the CORBA object request 
broker examines the request to determine whether fil- 
tering is requested and instantiates a server invocation 
object either from the parent class, if filtering is not 
requested, or from the subclass, if filtering is requested. 
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FIELD OF THE INVENTION 



CROSS REFERENCE TO RELATED APPLICATIONS 

[0001] The following U.S. patent applications are 
related to the present application and are incorporated 
by reference herein in their entirety: 

U.S. Patent Application Serial No. 08/554,794, filed 
11/07/95 as a continuation to U.S. Patent Applica- 
tion Serial No. 07/995,863, filed 12/21/92 (now 
abandoned); 

U.S. Patent Application Serial No. 08/670,682, filed 
6/26/96; 

U.S. Patent Application Serial No. 08/673,181, filed 
6/26/96; 

U.S. Patent Application Serial No. 08/670,700, filed 
6/26/96; 

U.S. Patent Application Serial No. 08/670,681 , filed 
6/26/96; 

U.S. Patent Application Serial No. 08/670,684, filed 
6/26/96; 

U.S. Patent Application Serial No. 08/669,782, filed 
6/26/96; 

U.S. Patent Application entitled "Method and Appa- 
ratus for Deferred Throwing of Exceptions in C++", 
filed by Christian J. Callsen and Ken M. Cav- 
anaugh, assigned attorney docket no. 
SUN1P171/P2736 and filed on an even date here- 
with; 

U.S. Patent Application entitled "Method and Appa- 
ratus for Fast, Local CORBA Object References", 
filed by Christian J. Callsen and Ken M. Cav- 
anaugh, assigned attorney docket no. 
SUN1P1 70/2735 and filed on an even date here- 
with; 

U.S. Patent Application entitled "Method and Appa- 
ratus for Constructing Stable Iterators in a Shared 
Data Collection", filed by Christian J. Callsen and 
Ken M. Cavanaugh, assigned attorney docket no. 
P2772/PJSI and filed on an even date herewith; 
U.S. Patent Application entitled, "Method and Appa- 
ratus for Enforcing Locking Invariants in Multi- 
Threaded Systems", filed by Christian J. Callsen 
and Ken M. Cavanaugh, assigned attorney docket 
no. P2747/PJSI and filed on an even date herewith; 
U.S. Patent Application entitled, "Filter Framework 
for Executing Code During Method Invocation", filed 
by Anita Jindal, Ken M. Cavanaugh, Sanjeev 
Krishnan and Rohit Garg, assigned attorney docket 
no. P2755/PJSI and filed on an even date herewith; 
and 

U.S. Patent Application Entitled, "Method and Appa- 
ratus for Efficient Representation of Variable Length 
Identifiers in a Distributed Object System", filed by 
Ken M. Cavanaugh, assigned attorney docket no. 
P2750/PJSI and filed on an even date herewith. 



[0002] This invention relates to distributed object sys- 
tems using Common Object Request Broker Architec- 
5 ture (CORBA) and, more particularly, to a method and 
apparatus for implementing pre-marshaling and post- 
marshaling filters in an object request broker. 
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BACKGROUND OF THE INVENTION 



[0003] Software programs are continually becoming 
more complicated. Early programs consisted of straight- 
forward procedural code that presented a simple, com- 
mand line interface and text display to the user. These 
is simple programs have gradually been replaced with 
complex programs that have graphical user interfaces 
and multiple features. 

[0004] As programs have grown in complexity, the 
amount of effort which is required to write and debug the 

20 programs has also increased drastically. Consequently, 
major efforts have been made to reduce the amount of 
programming necessary to produce a modern, full-fea- 
tured product One of the most successful of these 
efforts has been the development of object-oriented 

25 programming in which programs are designed as col- 
lections of discrete elements called "objects". The 
objects can be modified and re-used in many cases, 
thereby reducing the development effort. 
[0005] As will be understood by those skilled in the art, 

30 objects in the context of object-oriented programming 
are software entities comprising data and methods or 
operations on that data. The methods of an object col- 
lectively form an interface for manipulating the data in 
the object. The objects exist only at program runtime 

35 and are created, or instantiated, from object "classes" 
which are actually written by the programmer. The class 
code written by a programmer can be "reused" by 
another programmer by instantiating objects from that 
code. 

40 [0006] In order to further reduce the programming bur- 
den, distributed object systems have been developed in 
which methods in objects resident on a server can be 
executed or invoked remotely over a network from a cli- 
ent application. In this manner, the objects can be devel- 

45 oped and maintained by a party different from the party 
that developed the client application. In such a system 
information is routed or streamed between the client 
and the server. This information includes requests from 
the client to invoke an object on the server and results 

so and data from the method invocation returning from the 
server to the client. In addition, object-oriented pro- 
grams often communicate by streaming objects from 
one program to another. 

[0007] In such streaming operations, a stream writer 
55 organizes, or marshals, the information to form a serial 
data stream. The serial data stream is then sent to the 
server where a stream reader unmarshals the serial 
data stream to reconstruct a copy of the original infor- 
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mation. The stream reader must operate such that the 
unmarshaling exactly "undoes" the effect ol the mar- 
shaling so that the original information can be recon- 
structed. Ordinarily, such an operation does not present 
a problem, but when the stream reader is not written by 
the same author as the stream writer there can be 
incompatibilities. 

[0008] In order to standardize the marshaling and 
unmarshaling and data transfer process, an industry 
consortium called the Object Management Group 
(OMG) was formed whose mission is to define a set of 
interfaces for inter-operable software. Its first specifica- 
tion, the Common Object Request Broker Architecture 
(GORBA) specification, is an industry consensus stand- 
ard that hides all differences between programming lan- 
guages, operating systems, and object location. The 
CORBA standard defines an object request broker 
(ORB) that handles the marshaling, transport and 
unmarshaling of information between applications. The 
ORB functions as a communication infrastructure, 
transparently relaying object requests across distributed 
heterogeneous computing environments. Inter-opera- 
bility is accomplished through well-defined object inter- 
face specifications which allow client applications to 
connect to the ORB. CORBA provides an implementa- 
tion independent notation for defining interfaces called 
the OMG Interface Definition Language (IDL). 
[0009] The OMG CORBA specification defines an 
implementation independent object model which is 
actually built with a programming language, such as 
C++ or Java. In this model CORBA objects (also called 
"servants"), which are implemented by servers, have 
references that can be exported to clients. Clients and 
servers are roles, not mutually exclusive tasks for a sin- 
gle program, so that any one program can be both a cli- 
ent and a server. Objects and object references are 
typically different programming language objects, 
although they do not have to be. 
[0010] In a server, the implementation of an actual 
object which can be used to satisfy an invocation 
request on a CORBA object is generally both platform 
and language dependent and various models are possi- 
ble for implementing objects in servers. The original 
CORBA standard defined a Basic Object Adapter (or 
BOA) which is a framework that adapts the server 
implementation to the implementation independent 
ORB. A newer OMG portability standard defines a Port- 
able Object adapter (or POA), which replaces the BOA 
and is intended to be platform independent. Many 
ORBs also support other proprietary frameworks tor 
implementing CORBA objects. All of these frameworks 
are commonly referred to as Object Adapters (or OAs). 
[001 1 ] In some cases, it may be useful to filter a client 
request before, and after, the marshaling and unmar- 
shaling operations which occur during the delivery of 
the request from the client to the server. In addition, fil- 
tering can be performed before, and after, the marshal- 
ing and unmarshaling operations which occur during a 



reply when results of an invocation are returned from 
the server to the client. Filters can generally be classi- 
fied into three categories: pre-marshaling filters, post- 
marshaling filters, and transform filters. These catego- 
s ries are based on the points in the method invocation 
process where the filters are applied. The pre and post 
filters are generally applied in the same order for the di- 
em and the server and the filters can be enabled and 
disabled to provide selective filtering. 
10 [0012] Transform filters could be applied to the 
request, (a) on the client side after all pre/post filters 
have been applied, and (b) on the server side, before all 
pre/post filters have been applied to the request. Trans- 
form filters could be applied to the reply, (a) on server 
15 side after all pre/post filters have been applied to the 
reply message, and (b) on the client side before 
pre/post are applied to the reply message. The order in 
which the transform filters are invoked in one process 
are opposite of how they are invoked in the other proc- 
20 ess. Transform filters can also be enabled and disabled. 
[0013] An application programmer might use the pre 
and post filters for a variety of reasons. For example, 
they could be used to log and print messages. They 
could also be used to send or retrieve extraneous infor- 
ms mation which does not appear in the request or reply 
messages. Filters could also be used for implementing 
simple transaction support without using the service 
context list, or for providing debugging support for the 
ORB. Transform filters can be useful for implementing 
30 such operations as encryption/decryption of data or 
data compression. 

[0014] On the server side, the request and reply argu- 
ments are marshaled and unmarshaled in the imple- 
mentation specific skeleton code. If the filters are 

35 enabled and require filtering of the marshaled or unmar- 
shaled data, skeleton code needs to be generated 
which provides for filter invocation after the marshaling 
or unmarshaling operation. Therefore, different skele- 
tons would need to be generated depending on the 

40 quality of service - whether the request or reply was fil- 
terable or non-filterable. The result is proliferation of the 
skeleton code. 

[0015] There is therefore a need to achieve different 
quality of service without requiring changes to the skel- 
45 eton code for each different quality of service. 

SUMMARY OF THE INVENTION 

[0016] In accordance with the principles of the inven- 
so tion, the marshaling and unmarshaling process is 
encapsulated in a server invocation object created from 
a class which contains data, including the request ID, 
the marshal buffer and the marshal and unmarshal 
methods. Filtering is supported by extending the class 
55 with a subclass that overrides the marshal and unmar- 
shal methods to invoke the filters at the proper points. 
During method invocation, the ORB examines the 
request to determine whether filtering is requested and 
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instantiates an invocation object either from the parent 
class, if filtering is not requested, or from the subclass, 
if filtering is requested. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[001 7] The above and further advantages of the inven- 
tion may be better understood by referring to the follow- 
ing description in conjunction with the accompanying 
drawings in which: 

Figure 1 is a schematic block diagram of an illustra- 
tive hardware platform which forms part of a prior 
art computer system on which the invention can be 
run. 

Figure 2 is a schematic diagram of a prior art com- 
puter network system on which a CORBA system 
can be built. 

Figure 3 is a block schematic diagram illustrating a 
prior art CORBA environment and showing the 
relationship of the client, ORB, object adapter and 
server. 

Figure 4 is a block schematic diagram illustrating a 
CORBA environment and showing the location of 
various filters on the client and server sides. 
Figure 5 is a class diagram using Object Manage- 
ment Technique (OMT) diagrams to illustrate the 
relationship of the generic and filterable server invo- 
cation classes. 

Figure 6 is a block schematic diagram illustrating a 
CORBA environment and schematically illustrating 
an alternative server invocation object instantiation 
depending on whether the request and reply are fil- 
terable or not. 

Figure 7 is an illustrative flowchart describing the 
procedure followed by the ORB in instantiating the 
alternative server invocation objects. 
Figure 8 is an illustrative flowchart describing the 
operation of the marshal method in a Fifterable- 
Serverlnvocation object. 

Figure 9 is an illustrative flowchart describing the 
operation of the unmarshal method in a Filterable- 
Serverlnvocation object. 

DETAILED DESCRIPTION OF THE PREFERRED 
EMBODIMENT 

[0018] Figure 1 illustrates the system architecture for 
an exemplary client computer 100, such as an IBM 
THINKPAD 701® computer or Digital Equipment Cor- 
poration HiNote™ computer, on which the disclosed net- 
work access system (system) can be implemented. The 
exemplary computer system of Figure 1 is discussed 
only for descriptive purposes, however, and should not 
be considered a limitation of the invention. Although the 
description below may refer to terms commonly used in 
describing particular computer systems, the described 
concepts apply equally to other computer systems, 



including systems having architectures that are dissimi- 
lar to that shown in Figure 1 . 

[0019] The client computer 100 includes a central 
processing unit (CPU) 105, which may include a con- 

s ventional microprocessor, random access memory 
(RAM) 110 for temporary storage of information, and 
read only memory (ROM) 1 15 for permanent storage of 
information. A memory controller 120 is provided for 
controlling system RAM 110. A bus controller 125 is 

w provided for controlling bus 130, and an interrupt con- 
troller 135 is used for receiving and processing various 
interrupt signals from the other system components. 
[0020] Mass storage may be provided by diskette 1 42, 
CD-ROM 147, or hard disk 152. Data and software may 

15 be exchanged with client computer 100 via removable 
media, such as diskette 142 and CD-ROM 147. Diskette 
142 is insertable into diskette drive 141, which is con- 
nected to bus 130 by controller 140. Similarly, CD-ROM 
147 is insertable into CD-ROM drive 146, which is con- 

20 nected to bus 130 by controller 145. Finally, the hard 
disk 152 is part of a fixed disk drive 151 , which is con- 
nected to bus 130 by controller 150. 
[0021] User input to the client computer 100 may be 
provided by a number of devices. For example, a key- 

25 board 156 and a mouse 157 may be connected to bus 
130 by keyboard and mouse controller 155. An audio 
transducer 196, which may act as both a microphone 
and a speaker, is connected to bus 130 by audio con- 
troller 197. It should be obvious to those reasonably 

30 skilled in the art that other input devices, such as a pen 
and/or tablet and a microphone for voice input, may be 
connected to client computer 100 through bus 130 and 
an appropriate controller. DMA controller 160 is pro- 
vided for performing direct memory access to system 

35 RAM 1 10. A visual display is generated by a video con- 
troller 165, which controls video display 170. 
[0022] Client computer 100 also includes a network 
adapter 190 that allows the client computer 100 to be 
interconnected to a network 195 via a bus 191 . The net- 

40 work 195, which may be a local area network (LAN), a 
wide area network (WAN), or the Internet, may utilize 
general purpose communication lines that interconnect 
multiple network devices. 

[0023] Client computer system 100 generally is con- 
45 trolled and coordinated by operating system software, 
such as the WINDOWS 95® operating system (availa- 
ble from Microsoft Corp., Redmond, WA). Among other 
computer system control functions, the operating sys- 
tem controls allocation of system resources and per- 
se forms tasks such as process scheduling, memory 
management, networking and I/O services. 
[0024] Figure 2 illustrates, in a very simple fashion, the 
connection of a number of computing systems, such as 
that shown in Figure 1 . to form a distributed computing 
55 facility. Each of the individual stations 200. 202, 204, 
208 and 210 are interconnected by a network mecha- 
nism. Although the distributing computing facility could 
exist on a single computing system, it is more likely to 
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operate over a network transport medium. Such a trans- 
port medium may be LAN as shown in Figure 2, but may 
also be other network arrangements, including the Inter- 
net All that is necessary is that the terminals 200, 202, 
204, 208 and 210 be able to communicate with each 
other using predefined protocols to exchange informa- 
tion. As previously mentioned, the CORBA architecture 
overlays such a network and relieves the individual 
applications from dealing with the details of transporting 
information over the network. More particularly, the 
CORBA architecture hides all of the details and the 
actual network protocols from the application programs. 
It assures that the application programs operate with 
each other regardless of the platforms on which the 
software is designed to run and regardless of the net- 
work protocols used to interconnect separate comput- 
ing systems. 

[0025] Figure 3 illustrates, in a very schematic form, 
the basic CORBA architecture which defines a peer-to- 
peer distributed computing facility where all applications 
are objects (in the sense of object orientation). Objects 
can alternate between client roles 300 and server roles 
302. An object operates in a client role 300 when it is the 
originator of an object invocation. An object operates in 
a server role 302, called an object implementation, 
when it is the recipient of an object invocation. 
[0026] The client 300 communicates with the server 
302 by means of an object request broker or ORB 308. 
The ORB 308 operates with a transport 310 that con- 
veys information between the client 300 and server 302 
and, as previously mentioned, the ORB 308 handles the 
marshaling, transport and unmarshaling of information 
between client 300 and server 302. The client 300 com- 
municates with the ORB 308, as indicated schemati- 
cally by arrow 304, by means of an implementation 
independent syntax which describes object encapsula- 
tions. This syntax is called an interface definition lan- 
guage (IDL) and is defined in the CORBA specification 
generated by OMG. The OMG interface definition lan- 
guage can be used to define interfaces that have 
attributes and operation signatures. The language also 
supports inheritance between interface descriptions in 
order to facilitate reuse by developers. Objects or serv- 
ants in the server 302 export object references with 
interfaces specified by the OMG IDL for use by clients. 
The object reference contains an identification of the 
object implementation so that the object adapter 316 
can pass the request to the correct object in the server. 
[0027] The entire CORBA architecture is actually 
implemented in a conventional programming language, 
such as C, C++, Java or Smalltalk. Implementations in a 
variety of languages are available from a number of ven- 
dors who typically provide a IDL compiler bundled with 
their ORB products. The IDL compilers generate header 
files which define the OMG IDL interfaces and can be 
incorporated into application programs. The IDL compil- 
ers also generate stub code 306 and skeleton code 314 
for each interface. 



[0028] The client application program 300 can link 
directly to the OMG IDL stub code 306. As far as the cli- 
ent application program is concerned, an invocation of 
the stub code 306 appears to be a local function call. 

5 Once invoked, the stub code 306 provides an interface 
to the ORB 308 that performs marshaling to encode and 
decode the operation s parameters into communication 
formats suitable for transmission on the transport 310 to 
the server 302. 

10 [0029] At the server side, the OMG IDL skeleton code 
314 is the corresponding implementation of the OMG 
IDL interface. When the ORB 308 receives a request, 
the skeleton code 314 unmarshals the request parame- 
ters and generates a call, indicated schematically by 

is arrow 312, to an object implementation in the server 
302. When the server completes processing of the 
request, the skeleton code 314 and stub code 306 
return the results to the client program 300. If an error 
has occurred, exception information generated by the 

20 server or by the ORB is returned. 

[0030] An object adapter 316 comprises the interface 
between the ORB 308, the skeleton code 314 and the 
server 302. Object adapters, such as adapter 316. sup- 
port functions, such as registration of object implemen- 
ts tations and activation of servers. There are many 
potential types of object adapters, depending on the 
purpose of the adapter. The original CORBA specifica- 
tion defined only a general-purpose Basic Object 
Adapter or BOA. The BOA performs some basic func- 

30 tions. For example, when a client request specifies an 
inactive server process, the BOA automatically acti- 
vates the server process. When the server is activated it 
registers its implementation with the BOA. The BOA 
then stores this registration to use in future object 

35 requests. After an object is activated, it can receive cli- 
ent requests by means of a callback method in the skel- 
eton code 314. BOA services also include exception 
handling and object reference management. 
[0031] The block schematic diagram of Figure 4 illus- 

40 trates the addition of filters to the Figure 3 ORB archi- 
tecture. In Figure 4, elements which correspond to 
elements in Figure 3 have been given corresponding 
numeral designations. For example, stub code 306 in 
Figure 3 corresponds to stub code 406 in Figure 4. On 

45 the client side, the client 400 interacts with the stub 
code 406 which, in turn, communicates with the ORB 
408. The ORB 408 contains implementations of the cli- 
ent side filters 422 - 436. On the server side, the server 
filter registry 420 contains implementations of the 

so server side filters 438 - 452. 

[0032] Filters are classified in accordance with the rel- 
ative place within a method invocation process where 
they are applied and depending on the type of message 
to which they are applied. Thus, the fitters can be cate- 

55 gorized as pre-request, post-request, pre-reply, and 
post-reply filters. The pre-request filters 422 and 450 
are applied before marshaling 424 of arguments on the 
client side in a request message and before unmarshal- 
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ing 448 the request arguments in the skeleton 414. The 
post-request filters 426 and 446 are applied after mar- 
shaling 424 of arguments on the client side and after 
unmarshaling 443 the request arguments in the skele- 
ton 414. It should be noted that, although only one ele- 
ment is shown for each type of filter in Figure 4, there 
may actually be several separate pre-filters, several 
separate post-filters, etc. Each filter can be separately 
enabled or disabled. 

[0033] Similarly, the pre-reply filters 438 and 434 are 
applied before marshaling 440 of the reply results in the 
skeleton 414 and before unmarshaling 432 the reply 
results at the client side. The post-reply filters 442 and 
430 are applied after marshaling 440 of result values in 
the skeleton 414 and after unmarshaling 432 the results 
at the client side. 

[0034] Transform filters may also be employed to 
implement encryption and decryption of data or data 
compression. For example, client transform filter 428 
could be employed to encrypt data which is decrypted 
by server transform filter 452 and server transform filter 
444 would in turn encrypt data which is decrypted by cli- 
ent transform filter 436. There are two kinds of trans- 
form filters supported in the presently preferred 
embodiment of the invention, the request filter and the 
reply filter. The request filters, 428. 452, are invoked on 
the client side after all pre and post filters have been 
applied to the request message and on the server 
before pre and post filters are applied to the request 
message. The reply filters, 444, 436, are invoked on the 
server side after all pre and post filters have been 
applied to the reply message and on the client side 
before pre and post filters are applied to the reply mes- 
sage. The transform filters are applied only to the mes- 
sage body, not to the message header, because the 
object which is a part of the message header contains 
information that is required by the object request broker 
for dispatching the message to the appropriate subcon- 
tract and for selecting what particular transform filters to 
apply. However, a dummy message header could be 
generated in accordance with conventional protocols to 
allow for the application of transformation to the mes- 
sage header. This would allow for a proper dispatching 
to the correct subcontract. 

[0035] Figure 4 also illustrates a subcontract layer 407 
in the ORB 408. The subcontract layer 407 and subcon- 
tract/object adapter 416 can be used to convey quality 
of service (QOS) information. Illustratively, as explained 
below, it may be used to specify whether the request 
and reply arguments are filterable or not. 
[0036] A mechanism for implementing filters in the 
skeleton code is illustrated in Figure 5. A generic class 
called GenericServerl nvocation 500 is used to encap- 
sulate the data, for example the marshal buffer 502, 
request ID 504 and other data (not shown). The generic 
class also includes methods, such as the marshal 
method 506 and unmarshal method 508. In a Generic- 
Serverlnvocation object constructed from class 500, the 



10 

unmarshal method 508 would unmarshal data from the 
marshal buffer 502 using the format described in the 
argument descriptor (generated by the skeleton), and 
the marshal method 506 would marshal the message 

5 header and results into the marshall buffer. 

[0037] To support filterable behavior, one can extend 
the GenericServerlnvocation class 500, to define a 
class called FilterableServer Invocation 510. The Filtera- 
bleServerlnvocation class 510 contains marshal and 

io unmarshal methods, 512 and 514, which override the 
marshal and unmarshal methods, 506 and 508, of the 
GenericServerlnvocation class 500. 
[0038] The decision on which type of server invocation 
object should be generated is made at the ORB trans- 

15 port layer 610 as illustrated in Figures 6 and 7. As with 
Figure 4, elements in Figure 6 which correspond to ele- 
ments in Figures 3 and 4 have been given correspond- 
ing numerals. A method invocation begins in step 700 
and proceeds to step 702. As indicated in Figure 7, dur- 

20 ing a method invocation, the client object 600 sends a 
request with a subcontract ID in the object key to indi- 
cate whether the quality of service is "filterable". In step 
704, the ORB 608 checks the subcontract- ID in the 
object key as schematically illustrated by box 670. If, in 

25 step 706, the subcontract- ID indicates that the request 
is not filterable, then step 708 is executed where the 
ORB 608 creates a server invocation object 672 that is 
instance of the GenericServerlnvocation class 500. 
[0039] Alternatively, if, in step 706, the ORB 608 deter- 

30 mines that the request is filterable, then, in step 71 0, the 
ORB creates a server invocation object 674 that is 
instance of the FilterableServer Invocation class 510. 
[0040] If the GenericServerlnvocation class 500 is 
instantiated, the marshal and unmarshal methods, 506 

35 and 508, operate in a conventional fashion. However, if 
the FilterableServerlnvocation class 510 is instantiated, 
the marshal method 512 of the FilterableServerlnvoca- 
tion class 510 overrides the marshal method 506 of the 
GenericServerlnvocation class 500. 

40 [0041] The operation of the marshal method 512 is 
illustrated in Figure 8. The method starts in step 800 
and proceeds to step 802 where a check is made to 
determine if transform filters are enabled. If transform 
filters are enabled, the message header is not mar- 

45 shaled in the marshal buffer 502. In this case, the 
method 512 skips to step 806. If transform filters are not 
enabled, then step 804 is executed where the message 
header information is marshaled into the marshal buffer 
502. 

so [0042] In either case, the method 512 then invokes all 
of the pre-reply filters (step 806) marshals the message 
data into the marshal buffer 502 (step 808) and invokes 
all post-reply filters as set forth in step 810. The routine 
then ends in step 812. 

55 [0043] Similarly, if the FilterableServerlnvocation class 
510 is instantiated, the unmarshal method 514 of Filter- 
ableServerlnvocation class 510 overrides the unmar- 
shal method 508. The operation of the unmarshal 
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method 514 is illustrated in Figure 9. The method 
begins in step 900 and proceeds to step 902 where the 
method unmarshals arguments from the marshal buffer 
502 using the argument descriptor which is generated 
by the skeleton code 614, and then, in step 904, the 5 
method invokes the post-request filters. The method 
then finishes in step 906. 

[0044] A software implementation of the above- 
described embodiment may comprise a series of com- 
puter instructions either fixed on a tangible medium, 10 
such as a computer readable media, e.g. diskette 142, 
CD-ROM 147, ROM 115, or fixed disk 152 of Figure 1, 
or transmittable to a computer system, via a modem or 
other interface device, such as communications adapter 
190 connected to the network 195 over a medium 191. 15 
Medium 191 can be either a tangible medium, including 
but not limited to optical or analog communications 
lines, or may be implemented with wireless techniques, 
including but not limited to microwave, infrared or other 
transmission techniques. It may also be the Internet. 20 
The series of computer instructions embodies all or part 
of the functionality previously described herein with 
respect to the invention. Those skilled in the art will 
appreciate that such computer instructions can be writ- 
ten in a number of programming languages for use with 25 
many computer architectures or operating systems. 
Further, such instructions may be stored using any 
memory technology, present or future, including, but not 
limited to, semiconductor, magnetic, optical or other 
memory devices, or transmitted using any communica- 30 
tions technology, present or future, including but not lim- 
ited to optical, infrared, microwave, or other 
transmission technologies. It is contemplated that such 
a computer program product may be distributed as a 
removable media with accompanying printed or elec- 35 
tronic documentation, e.g., shrink wrapped software, 
pre-loaded with a computer system, e.g., on system 
ROM or fixed disk, or distributed from a server or elec- 
tronic bulletin board over a network, e.g., the Internet or 
World Wide Web 40 
[0045] Although an exemplary embodiment of the 
invention has been disclosed, it will be apparent to 
those skilled in the art that various changes and modifi- 
cations can be made which will achieve some of the 
advantages of the invention without departing from the 45 
spirit and scope of the invention. It will be obvious to 
those reasonably skilled in the art that other compo- 
nents performing the same functions may be suitably 
substituted. Further, the methods of the invention may 
be achieved in either all software implementations, so 
using the appropriate processor instructions, or in 
hybrid implementations which utilize a combination of 
hardware logic and software logic to achieve the same 
results. Further, aspects such as the size of memory, 
number of bits utilized to represent the compact identif i- 55 
ers, and the specific configuration of logic and/or 
instructions utilized to achieve a particular function, as 
well as other modifications to the inventive concept are 
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intended to be covered by the appended claims. 
Claims 

1. Apparatus for use in a distributed object system 
having client and server objects, the apparatus exe- 
cuting programmer specified code within imple- 
mentation specific code connecting the server 
object to the distributed object system when 
generic marshal and unmarshal methods are exe- 
cuted during a method invocation, the apparatus 
comprising: 

a filter which executes programmer specified 

code during the method invocation; 

a generic class for constructing a generic 

server invocation object containing the generic 

marshal and unmarshal methods; 

a filterable class derived from the generic class 

for constructing a filterable server invocation 

object containing overriding marshal and 

unmarshal methods that override the generic 

marshal and unmarshal methods and invoke 

the filter; and 

a mechanism which examines a request gener- 
ated by the client and instantiates a server 
invocation object from the generic class when 
the request indicates that the method invoca- 
tion is not filterable and instantiates a server 
invocation object from the filterable class when 
the request indicates that the method invoca- 
tion is filterable. 

2. Apparatus according to claim 1 wherein the filtera- 
ble server invocation object contains overriding 
marshal and unmarshal methods that call the 
generic marshal and unmarshal methods and 
invoke the filter. 

3. Apparatus according to claim 1 wherein the distrib- 
uted object system comprises an object request 
broker and wherein the mechanism for instantiating 
the server invocation object is located in the object 
request broker. 

4. Apparatus according to claim 3 wherein the request 
contains a subcontract ID identifying whether the 
method invocation is filterable and wherein the 
mechanism for instantiating the server invocation 
object examines the subcontract ID to determine 
whether the method invocation is filterable. 

5. Apparatus according to claim 4 wherein the sub- 
contract ID is configured to specify a filterable qual- 
ity of service. 

6. Apparatus according to claim 1 wherein the generic 
server invocation object contains a marshal buffer 
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and request ID field. 

7. Apparatus according to claim 1 further comprising a 
transform filter which executes programmer speci- 
fied code after the filter, wherein the request has a 
header and wherein the marshal method in the fil- 
terable server invocation object does not marshal 
the header when the transform filter is enabled. 

8. A method for use in a distributed object system hav- 
ing client and server objects, the method executing 
programmer specified code within implementation 
specific code connecting the server object to the 
distributed object system when generic marshal 
and unmarshal methods are executed during a 
method invocation, the method comprising the 
steps of: 

(a) constructing a filter which executes pro- 
grammer specified code during the method 
invocation; 

(b) creating a generic class for constructing a 
generic server invocation object containing the 
generic marshal and unmarshal methods; 

(c) creating a filterable class derived from the 
generic class for constructing a filterable server 
invocation object containing overriding marshal 
and unmarshal methods that override the 
generic marshal and unmarshal methods and 
invoke the filter; and 

(d) examining a request generated by the client 
and instantiating a server invocation object 
from the generic class when the request indi- 
cates that the method invocation is not filtera- 
ble and instantiating a server invocation object 
from the filterable class when the request indi- 
cates that the method invocation is filterable. 

9. A method according to claim 8 wherein step (c) 
comprises the step of: 

(d) creating the filterable server invocation 
object with overriding marshal and unmarshal 
methods that call the generic marshal and 
unmarshal methods and invoke the filter. 

10. A method according to claim 8 wherein the distrib- 
uted object system comprises an object request 
broker and wherein step (d) comprises the step of: 

(d1) using a mechanism in the object request 
broker to instantiate the server invocation 
object. 

11. A method according to claim 10 wherein the 
request contains a subcontract ID identifying 
whether the method invocation is filterable and 
wherein step (d) comprises the step of: 



(d2) examining the subcontract ID to determine 
whether the method invocation is filterable. 

12. A method according to claim 11 wherein step (d) 
5 comprises the step of: 

(d3) configuring the subcontract ID to specify a 
filterable quality of service. 

10 13. A method according to claim 8 wherein step (b) 
comprises the step of: 

(b1) creating a generic server invocation class 
that instantiates a generic server invocation 
is object that contains a marshal buffer and 

request ID field. 

14. A method according to claim 8 wherein step (a) 
comprises the step of: 

20 

(a1) constructing a transform filter which exe- 
cutes programmer specified code after the fil- 
ter, and wherein the request has a header and 
wherein the method further comprises the step 
25 of: 

(e) causing the filterable server invocation 
object to skip marshaling of the header when 
the transform filter is enabled. 

30 1 5. A computer program product for use in a distributed 
object system having client and server objects, the 
computer program product causing the execution of 
programmer specified code within implementation 
specific code connecting the server object to the 

35 distributed object system when generic marshal 
and unmarshal methods are executed during a 
method invocation, the computer program product 
comprising a computer usable medium having 
computer readable program code thereon includ- 

40 ing: 

program code for constructing a fitter which 
executes programmer specified code during 
the method invocation; 
45 generic server invocation class code construct- 

ing a generic server invocation object contain- 
ing the generic marshal and unmarshal 
methods; 

filterable server invocation class code for creat- 
50 ing a filterable class derived from the generic 

class for constructing a filterable server invoca- 
tion object containing overriding marshal and 
unmarshal methods that override the generic 
marshal and unmarshal methods and invoke 
55 the filter; and 

program code for examining a request gener- 
ated by the client and instantiating a server 
invocation object from the generic class when 
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the request indicates that the method invoca- 
tion is not filterable and instantiating a server 
invocation object from the filterable class when 
the request indicates that the method invoca- 
tion is filterable. 5 

16. A computer program product according to claim 15 
wherein the filterable server invocation class code 
comprises program code that calls the generic mar- 
shal and unmarshal methods and invokes the filter 10 

17. A computer program product according to claim 15 
wherein the distributed object system comprises an 
object request broker and the program code for 
examining the request comprises program code in is 
the object request broker which instantiates the 
server invocation object. 

18. A computer program product according to claim 1 7 
wherein the request contains a subcontract ID iden- 
tifying whether the method invocation is filterable 
and wherein the program code for examining the 
request comprises program code for examining the 
subcontract ID to determine whether the method 
invocation is filterable. 

19. A computer program product according to claim 18 
wherein the program code for examining the 
request comprises program code for configuring 
the subcontract ID to specify a filterable quality of 30 
service. 

20. A computer program product according to claim 15 
wherein the generic server invocation class code 
comprises program code for instantiating a generic 35 
server invocation object that contains a marshal 
buffer and request ID field. 

21. A computer program product according to claim 15 
wherein the program code for constructing a filter 40 
comprises program code for constructing a trans- 
form filter which executes programmer specified 
code after the filter, and wherein the request has a 
header and wherein the computer program product 
further comprises program code for skipping mar- 45 
shaling of the header when the transform filter is 
enabled. 
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